Function            strwicmp - compares a wild-carded string to
                                   another string, without case
                                   sensitivity

  Syntax              int strwicmp(char *wstr, char *str);

  Prototype in        stringhk.h

  Remarks             strwicmp performs an unsigned comparison of wstr
                      and str, starting with the first character in each
                      string and continuing with subsequent characters
                      until the corresponding characters differ or until
                      the end of the strings is reached. Wildcards (*,?)
                      are supported, as per DOS (* wildcards 0 or more
                      characters, ? wildcards a single character). The
                      comparison is not case sensitive.

  Return value        strwicmp returns a value that is

                           < 0       if wstr is less than str
                           = 0       if wstr is the same as str
                           > 0       if wstr is greater than str

                      Furthermore, if a comparison falls through during a
                      wildcard matching, -2 or 2 is returned. If a
                      mismatch is found without using wildcards, a -1 or
                      1 is returned.

  See also            strwcmp()